ATOM Documentation

← Back to App

Production Setup Guide: Integrations, Stripe & Super Admin

This guide outlines the steps to configure your production environment for Stripe billing, 3rd party integrations, and Super Admin access.

1. Configure Environment Variables (Vault Secrets)

You must set the following secrets in your cloud application. You can do this via the ATOM Cloud CLI:

atom-cli secrets set KEY=VALUE

Stripe Configuration

SecretDescription
STRIPE_SECRET_KEYYour Stripe secret key (sk_live_...)
STRIPE_PUBLISHABLE_KEYYour Stripe publishable key (pk_live_...)
STRIPE_WEBHOOK_SECRETYour Stripe webhook signing secret (whsec_...)
STRIPE_PRICE_ID_SOLOPrice ID for the Solo plan
STRIPE_PRICE_ID_TEAMPrice ID for the Team plan
STRIPE_PRICE_ID_ENTERPRISEPrice ID for the Enterprise plan

3rd Party Integrations (OAuth)

SecretDescription
SALESFORCE_CLIENT_IDSalesforce Connected App Client ID
SALESFORCE_CLIENT_SECRETSalesforce Connected App Client Secret
HUBSPOT_CLIENT_IDHubSpot App Client ID
HUBSPOT_CLIENT_SECRETHubSpot App Client Secret
SLACK_CLIENT_IDSlack App Client ID
SLACK_CLIENT_SECRETSlack App Client Secret
GOOGLE_CLIENT_IDGoogle OAuth Client ID
GOOGLE_CLIENT_SECRETGoogle OAuth Client Secret
MICROSOFT_CLIENT_IDMicrosoft Azure AD Client ID
MICROSOFT_CLIENT_SECRETMicrosoft Azure AD Client Secret

Core App Configuration

SecretDescription
NEXTAUTH_URLYour production URL (e.g., https://[tenant].atomagentos.com)
JWT_SECRETA secure random string for JWT signing

---

2. Setup Super Admin Account

We have provided a script to seed the admin tables and create your Super Admin account in the production database.

Step 2a: Run the Setup Script Locally (Connected to Prod DB)

If you have DATABASE_URL (with production credentials) set locally, run:

python3 scripts/setup_super_admin.py <your-email> <secure-password> "<Your Name>"

Step 2b: Run the Setup Script via Remote Console (Recommended)

You can run the script directly on your production machine:

atom-cli console
# Inside the console:
python3 scripts/setup_super_admin.py <your-email> <secure-password> "<Your Name>"
exit

---

3. Verify Access

  1. Navigate to https://your-domain.com/auth/signin.
  2. Login with your admin email and password.
  3. You should be redirected to the Super Admin Dashboard.

5. Detailed Configuration Guides

For more in-depth setup instructions, refer to the following documents: